Linux 용

AMS 를 Linux에 설치

1. 개요

• 본 문서는 AMS 을 Linux 에서 설치하는 과정 표준 가이드입니다.

2. 준비 사항

주의사항

root 계정으로 진행

필요 환경

• OS : Linux
• DB : MariaDB
• AMS 서버 설치 파일

3. AMS 초기 설치파일

가. 설치파일 압축해제

1. AMS 설치파일을 /home/softcamp 하위에 업로드 후 압축해제 및 사용자계정 권한부여

tar -xvf /home/softcamp/AMS.tar -C/home/softcamp

나. 설치 스크립트실행

1. AMS 데이터베이스 생성 스크립트파일 경로로 이동
2. AMS Null DB 구성 스크립트 실행

cd /home/softcamp/AMS/db/AMSDB_MariaDB_v4.135/01_AMSDB_생성\ 스크립트/

mysql -u root < 01_AMSDB_TB_SP.sql
mysql -u root < 02_AMSDB_DATA.sql
mysql -u root < 03_SP_TRANSFER_INSADATA.sql
mysql -u root < 04_표준\ 기능\ 커스텀정책\ 등록\ 스크립트.sql

4. Tomcat 서비스 실행

주의사항

softcamp계정으로 진행.

1. Tomcat 시작 스크립트가 존재하는 경로로 이동
2. Tomcat 서비스 시작 스크립트 실행

cd /home/softcamp/AMS/app/tomcat8.5/

./tomcat_start.sh

5. AMS 웹 페이지 접근 가능 IP 설정

1. MARIADB 혹은 DB tool을 이용하여 DB접속 후 아래 쿼리 실행 'IP' 부분을 접속을 시도하고자 하는 IP 입력

DB 접속시

mysql –u amsadmin –p

password: softcamp1!  

DB 접속 후 쿼리 입력

use amsdb;

insert into systemaccessip_info (Num, SystemAccess_IP, V6_Type, Update_date) (SELECT ifnull(MAX(num),'0')+1, 'IP', '0', now() from systemaccessip_info);

6. AMS 웹페이지 접속

1. 브라우저 주소창에 IP:80/ams 입력 (포트 확인 경로 : /home/softcamp/AMS/app/tomcat8.5/conf/server.xml)

• http://서버IP:80/ams/login.do

ID : amsmanager
PW : softcamp

7. AMS 이용을 위한 KeyManager 등록

Service Linker 연동가이드 참조

8. 참고사항

가. 포트 수정

주의사항

AMS 동작 포트는 Default 값 80 이지만 softcamp 계정에서는 80포트를 이용하지 못하기 때문에

다른포트로 리다이렉션 시켜주거나 동작포트를 변경해주어야 한다.

1. AMS 동작 포트 변경
2. 아래의 경로에 존재하는 server.xml 파일 오픈
3. port = "80" 해당부분 값 수정
4. 포트변경시에는 방화벽에 해당포트 오픈 필요

vi /AMS/app/tomcat8.5/conf/server.xml

Connector port="80" protocol="HTTP/1.1"

        connectionTimeout="20000"

        redirectPort="8445" URIEncoding="UTF-8"/

• 포트수정후에는 Tomcat 재시작이 필요
• Tomcat 재시작은 Tomcat 서비스 동작 스크립트가 존재하는 곳으로 이동하여 Tomcat 서비스 정지 스크립트 동작후, 시작스크립트 동작

나. AMS HTTPS(SSL) 통신

승인반출시스템에 HTTPS(SSL)적용을 위해선

1. Tomcat설정에 인증서 적용(인증서 업체에서 적용 방법 가이드 받아야 함)

• /AMS/app/Tomcat8.5/conf/server.xml 파일을 수정하여 SSL 인증서 적용

2. 승인반출매니저를 접속하여 설정 변경

• 시스템 관리 : 승인반출시스템 URL 값을 http://주소 -> https://주소 로 변경
• 커스텀정책 관리 : AMS_SP_0003 정책ID 사용으로 변경

노트

AMS_SP_0003 정책ID 없는 경우 추가 쿼리

INSERT INTO CustomPolicy_Info(Policy_Id, Value_Id, Policy_name, Policy_Value, Policy_Use, Policy_Info, Site_Id, Insert_Date, TopGroup_ID) 
VALUES (N'AMS_SP_0003', 1, N'승인 반출 시스템 접속 시 보안 프로토콜 변경 기능', N'Y', N'Y', N'승인 반출 시스템 접속 시 보안 프로토콜 변경 기능(http --> https)', @SiteId, GETDATE(), N'all');

3. 관리자 콘솔 접속하여 정책 변경

• 커스텀정책 > SCAP_AMS_SSL 정책 사용함 및 정책값 체크
• 커스텀정책 > EXPORT_DATA/EXPORT_DATA_TRAY > 값에 https://주소 로 변경

주의사항

승인반출 로컬서버를 이용하여 자동 로그인을 사용하는 경우 승인반출 시스템(src) -> 사용자 PC의 로컬서버(dest)로 방화벽 오픈되어야함.

HTTP 통신의 경우 브라우져에서 클라이언트의 로컬서버(62006포트)로 통신하기 때문에 별도의 작업 필요X HTTPS 통신의 경우 AMS 서버에서 클라이언트의 로컬서버(62006포트)로 직접통신하기 때문에 서버 방화벽 포트오픈 필요O

다. DB 접속 계정

1. DB 접속 계정은 NullDB 구성 스크립트 1번 스크립트 속에 포함
2. DB 접속계정은 임의로 생성하여도 무관 해당계정은 AMSDB 접근권한이 있어야함

라. 접속계정 등록 설정파일

1. 설정파일 context-datasource.xml 오픈하여 DB접속계정 정보 입력
   • property name="username" value=" "
   • property name="password" value=" "

vi /home/softcamp/AMS/data/ams/context-datasource.xml

MariaDB 

    bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"

        property name="driverClassName" value="org.mariadb.jdbc.Driver"/

        property name="url" value="jdbc:mariadb://127.0.0.1:3306/amsdb"/

        property name="username" value=""/

        property name="password" value=""/

9. 문서보안 관리자 콘솔 설정

• 애드인 모듈 등록(C:\Windows\SOFTCAMP\SDK경로에 모듈 존재)

- SCAI_SubmitNotificationUtil.dll - SCAI_SubmitNotificationUtil64.dll

• 커스텀 정책 등록

커스텀정책ID	제목	TYPE	정책값	설명
SCAP_AMS_V2_USE	[AMS]승인반출 고도화 서버 사용여부	CHECK ON/OFF	Check ON	승인반출 고도화 서버 사용여부
EXPORT_DATA	[AMS]파일 우클릭 시 승인 반출 메뉴 표기	EDIT	승인반출시스템 결재 신청;http://IP:PORT/ams/user/app/write.do	파일에서 우클릭시 승인반출시스템 접속 메뉴 표시 정책
EXPORT_DATA_TRAY	[AMS]트레이 아이콘의 승인 반출 메뉴 표기	EDIT	승인반출시스템 결재 신청;http://IP:PORT/ams	트레이아이콘에서 우클릭시 승인반출시스템 접속 메뉴 표시 정책
SCAP_AMS_SHELL_POLIC	[AMS]승인반출 우클릭 메뉴 발형정책	EDIT	SCAP_AMS_SHELL_POLICY 정책값 및 설정 예시 참고	승인반출 우클릭 매뉴 발현 정책이며, 사용할 항목의 값을 더하여 설정함, 첫번째값 DS, 두번째값 S-Work, 세번째값 MAXEON
SCAI_USE_AMS_WEB_BROWSER	AMS Web Browser 사용 여부	CHECK ON/OFF	Check	AMS Web Browser 사용 여부
AMS_SSO_TOKEN_URL	AMS 에서 SSO Token 관련 URL 설정	Edit	http://IP:PORT/ams/api/getToken;http://IP:PORT/ams/res/ssoLogin.do?token=	사용자의 TokenData ; SSO login 할 URL 설정 해야 함gettoken;ssologin ";" 로 구분``예) http://10.10.10.210/ams/api/getToken;http://10.10.10.210/ams/res/ssoLogin.do?token=

---

SCAP_AMS_SHELL_POLICY 정책값

구분	플래그
일반 탐색기	1 : 일반문서 2 : 보안문서
보안 탐색기	4 : 일반영역 8 : 보안영역 16 : 보안문서 32 : 일반문서
MAXEON 반출 폴더제어 정책	0 : 사용안함 1 :사용

SCAP_AMS_SHELL_POLICY 설정 예시

• 일반탐색기에서 보안문서에만 메뉴 표시 : 2|0|0
• 일반탐색기에서 지원하는 일반/보안문서에 메뉴 표시 : 3|0|0단, 승인반출에서 일반문서 업로드 정책이 있어야함.
• 보안탐색기의 보안영역 중 보안문서 적용 : 0|24|0
• 보안탐색기의 보안영역 중 일반문서, 보안문서 적용 : 0|56|0
• 24나 56은 각 플래그를 더한 숫자( 24 = 8+16 , 56 = 8+16+32)

문서보안 트레이 아이콘 메뉴에서 다국어 지원이 필요한 경우엔 로컬셋 설정을 통한 승인반출 메뉴 설정

로컬셋 명	설정 값	비고
USE_CUSTOM_MENU (6384)	0|승인반출시스템|http://IP:PORT/ams|||1|

---

** 커스텀 정책으로 등록한 메뉴명으로 표기가 안되는 현상 조치 방법 : C:\Windows\Softcamp\SDK\Res\DS\ResUIKOR.rc에 [SCAI_SubmitNotificationUtil]항목이 존재하면 해당 값을 사용함. **

10. 승인반출 관리자 페이지(커스텀정책) 설정

POLICY_ID	VALUE_ID	POLICY_NAME	POLICY_VALUE	POLICY_USE	POLICY_INFO
AMS_SP_0013	1	DS 클라이언트 SSO 로그인 기능 사용 여부	Y	Y	DS 클라이언트 SSO 로그인 기능 사용 여부
AMS_SP_0013	2	DS 클라이언트 SSO 로그인 기능 - SCI 서버 ID	SCAM-ED72-262C-433A-9111	Y	토큰 발급 및 SSO 허용을 위한 SCI 서버 ID 등록

AMS_WEB_BROWSER 미사용이고 외부 반출 기능 사용 시 S-Work 제어프로그램 등록

- 프로세스 : SCTL_AMSRpcLocalSvr.exe

- 타입 : 보안영역 접근 허용, 일반영역 저장 허용

- 상속 체크 해제

11. AMS 암호화 해제 시 파수 보안 문서 복호화 기능 추가

파수 라이브러리 모듈 패치 방법

• 해당 내용은 AMS에 파수 라이브러리 모듈을 적용하는 방법에 대한 가이드입니다.
• 라이브러리 버전 fasoo-jni-3.9.0u.jar, fcwpkg_jni-1.9.0.jar 기준으로 작성되었습니다.
• 버전이 다를경우 패치 방법이 달라질 수 있습니다.

정보

표준 설치 패키지에는 fsdinit 폴더가 포함되어 있기 때문에 별도의 패치 작업은 필요 없습니다. (기존에 AMS가 설치된 서버에만 패치 필요)

주의사항

root 계정으로 진행

가. 라이선스 파일 복사

cd /home/사용자/AMS/data/ams/convert/fsdinit/conf

• conf 파일의 이름은 고객사마다 다를 수 있음
• 상기 6개의 파일은 파수에서 해당 고객사 전용으로 발급된 파일을 받아서 해당 경로에 복사

나. 라이브러리 모듈 복사

cd /home/사용자/AMS/app/tomcat/bin

다. API 모듈 복사

cd /home/사용자/AMS/app/tomcat/lib

라. 파수 모듈 설치 파일 복사

cd /home/사용자/AMS/app/tomcat

마. 파수 설치 파일 실행

./fasoo_install.sh

관련 커스텀 정책

Policy_Id	Value_Id	Policy_Name	Policy_Value	Policy_Use	Policy_Info
AMS_CP_0171	1	암호화 해제시 파수복호화 사용여부	Y	Y	암호화 해제시 파수복호화 사용여부
AMS_CP_0058	18	문서 변환 - 파수 라이선스 파일명	0003714802064874	Y	문서 변환 - 파수 라이선스 파일명 (고객사에 맞게 수정 필요) \AMS\data\ams\convert\fsdinit\conf\ 경로에서 .conf 확장자 파일명을 입력
AMS_CP_0093	1	파일 추가 시 일반파일 첨부 가능 사용 여부	Y	Y	결재 완료 후 암호화된 문서는 복호화하여 일반문서와 같이 다운로드
AMS_CP_0093	2	파일 추가 시 일반파일 첨부 가능 - 요청 방법 설정	D|S|SW	Y	특정 요청 방법만 동작하도록 요청 방법 코드 설정 (파이프로 구분하여 다중 설정 가능)

커스텀 정책 등록 스크립트

USE `amsdb`;
 
INSERT INTO CustomPolicy_Info(Policy_Id, Value_Id, Policy_name, Policy_Value, Policy_Use, Policy_Info, Site_Id, Insert_Date, TopGroup_ID)
VALUES (N'AMS_CP_0171', 1, N'암호화 해제시 파수복호화 사용여부', N'Y', N'Y', N'암호화 해제시 파수복호화 사용여부', '', now(), N'all');
 
INSERT INTO CustomPolicy_Info(Policy_Id, Value_Id, Policy_name, Policy_Value, Policy_Use, Policy_Info, Site_Id, Insert_Date, TopGroup_ID)
VALUES (N'AMS_CP_0058', 18, N'문서 변환 - 파수 라이선스 파일명', N'0000000000011028', N'Y', N'\AMS\data\ams\convert\fsdinit\conf\ 경로에서 conf 확장자 파일명을 입력', '', now(), N'all');
 
INSERT INTO CustomPolicy_Info(Policy_Id, Value_Id, Policy_name, Policy_Value, Policy_Use, Policy_Info, Site_Id, Insert_Date, TopGroup_ID)
VALUES (N'AMS_CP_0093', 1, N'파일 추가 시 일반파일 첨부 가능 사용 여부', N'Y', N'Y', N'파일 추가 시 일반파일 첨부 가능 사용 여부 - 일반문서 및 암호화된 문서를 혼합하여 첨부 가능 - 결재 완료 후 암호화된 문서는 복호화 하여 일반문서와 같이 다운로드', '', now(), N'all');
 
INSERT INTO CustomPolicy_Info(Policy_Id, Value_Id, Policy_name, Policy_Value, Policy_Use, Policy_Info, Site_Id, Insert_Date, TopGroup_ID)
VALUES (N'AMS_CP_0093', 2, N'파일 추가 시 일반파일 첨부 가능 - 요청 방법 설정', N'D|S|SW', N'Y', N'특정 요청 방법만 동작하도록 요청 방법 코드 설정 (파이프로 구분하여 다중 설정 가능)', '', now(), N'all');

정책에 따른 첨부파일 처리 로직

커스텀 정책 적용 여부	첨부 문서 종류	처리 내용
정책 미사용	일반 문서	결재 신청 차단
정책 미사용	소프트캠프 보안 문서	결재 신청 가능 → 결재 승인 시 복호화
정책 미사용	파수 보안 문서	결재 신청 차단
정책 사용	일반 문서	결재 신청 가능 → 결재 승인 시 일반 문서 유지
정책 사용	소프트캠프 보안 문서	결재 신청 가능 → 결재 승인 시 복호화
정책 사용	파수 보안 문서	결재 신청 가능 → 결재 승인 시 복호화

• 복호화 로직 관련 톰캣 로그

파수 복호화시 리턴 코드

코드	코드 내용
0	복호화 성공
20	파일을 찾을 수 없습니다.
21	파일 사이즈가 0 입니다.
22	파일을 읽을 수 없습니다.
26	FSD 파일입니다.
29	암호화 파일이 아닙니다.
101	MarkAny 파일입니다.
103	FSN 파일입니다.
104	INCAPS 파일입니다.
105	Wrapsody 파일입니다.
106	NX 파일입니다.